Cream of the Crop 12/Cream of the Crop 12 (Part II)/Cream of the Crop 12 (Part II).iso/OS2/GCPFTP.ZIP/GCPFTP.HLP

OS/2 Help File | 1996-04-30 | 127.3 KB | 2,848 lines

ΓòÉΓòÉΓòÉ 1. Title Page and Information ΓòÉΓòÉΓòÉ

                               GCPFTP - Gibbon FTP
                  Copyright 1996 Gibbon Computer Products, Inc.
                              All rights reserved.

Gibbon FTP is a Presentation Manager application that allows you to browse the
directories of ftp servers, and upload and download files.  It is drag-and-drop
enabled for easy file transfer.  Gibbon FTP has the ability to queue transfers,
and it has a transfer status window that displays information about file
transfers including the troughput rate and estimated time remaining.

Copyrights and Trademarks
Legal Notices
Info-ZIP
About Gibbon Computer Products, Inc.
Contact Information
Shareware Registration
Groups and Servers Window
Settings Notebook
General Settings
Server Settings
Session Window
Command Line Switches
How Do I...?


ΓòÉΓòÉΓòÉ 1.1. Copyrights, Trademarks and Legal Notices ΓòÉΓòÉΓòÉ

The stylized GCP logo is a trademark of Gibbon Computer Products, Inc.

GCP and the Gibbon label for computer software and hardware products are
trademarks of Gibbon Computer Products, Inc.

IBM and OS/2 are registered trademarks of International Business Machines
Corporation, Armonk, N.Y.

This product includes software developed by the University of California,
Berkeley and its contributors.

PGP is a trademark of Philip R. Zimmermann.


ΓòÉΓòÉΓòÉ 1.2. Legal Notices ΓòÉΓòÉΓòÉ

Copyright and License

This document, the executable program file(s), accompanying DLL's,
configuration files, command files, and additional documentation ("the
software") are copyrighted by the author.  The copyright owner hereby licenses
you to use the sofware given these restrictions:

 1. No changes may be made to any part of the software other than the
    "branding" of the executables with registration information, and those
    changes commonly made to configuration files.

 2. The software package must be distributed in its entirety.  The package is a
    ZIP file containing:

    a. An archive file containing the executable program file, DLL's, support
       files and documentation.
    b. A PGP detached signature file which is used to verify the authenticity
       of the above archive file.
    c. A documentation file
    d. A registration form
    e. An installation program

    Any distribution of this package must contain all the original files in
    their original formats.  Any changes to the inner archive file will cause
    the PGP signature file to be invalid.  This is strictly against the terms
    of this license.  The outer ZIP file may be changed to add BBS comments, if
    desired.

 3. A trial period is assigned to each piece of software.  The trial period is
    defined as a number of days or a number of uses of the program, whichever
    is greater.  A typical trial is thirty days or thirty uses.  Usage is
    counted when a program is started.  See the Product Information panel for
    the usage counts for this particular software.  Use beyond this trial
    period is prohibited without registering the software.

    Warning: Once the trial period has passed, this program will no longer
    function.

 4. No fee or charge is to be collected for the distribution of the software in
    excess of $10.00US to cover the costs of materials, handling, postage and
    general overhead.

WARRANTY DISCLAIMER

Gibbon Computer Products, Inc. makes no warranty of any kind, either express or
implied, including but not limited to implied warranties of merchantability and
fitness for a particular purpose, with respect to this software and
accompanying documentation.

IN NO EVENT SHALL GIBBON COMPUTER PRODUCTS BE LIABLE FOR ANY SPECIAL,
INCIDENTAL, CONSEQUENTIAL, INDIRECT OR SIMILAR DAMAGES (INCLUDING DAMAGES FOR
LOSS OF BUSINESS PROFITS, BUSINESS INTERRUPTION, LOSS OF BUSINESS INFORMATION,
OR OTHER PECUNIARY LOSS) ARISING OUT OF THE USE OF, MISUSE OF OR INABILITY TO
USE THIS PROGRAM, EVEN IF GIBBON COMPUTER PRODUCTS, INC. HAS BEEN ADVISED OF
THE POSSIBILITY OF SUCH DAMAGES.


ΓòÉΓòÉΓòÉ 1.3. Info-ZIP ΓòÉΓòÉΓòÉ

Packages distributed by Gibbon Computer Products, Inc. are packaged using
Info-ZIP's compression utility.  The GCPUNZIP.DLL file was created from
slightly modified sources from the Info-ZIP group.  It is a DLL version of the
UnZip program, callable from other programs. The Gibbon Install program
(GCPINSTL.EXE) uses this DLL to uncompress the distribution files during
installation.

Some of the ideas used in GCP's DLL version of UnZip were inspired by changes
IBM made to create their UNZIP.DLL.

There are no extra charges or costs due to the use of this code, and the
original compression sources for the DLL are freely available from the Internet
at ftp://ftp.gibbon.com/pub/gcp/gcpunzip/gcpunzip.zip. The original source for
Info-ZIP's software (Zip, UnZip and related utilities) is free and can be
obtained as source code or executables from various bulletin board services and
anonymous-ftp sites, including CompuServe's IBMPRO forum and
ftp.uu.net:/pub/archiving/zip/*.

An official DLL version of UnZip is being worked on by the Info-ZIP and is
scheduled to be available in the fall of 1995.  If you want to use a DLL, you
should get the official version.

Original Info-ZIP COPYING file

This is the Info-ZIP file COPYING (for UnZip), last updated 10 Aug 94.

There are currently three explicit copyrights on portions of UnZip code (at
least, of which Info-ZIP is aware):  the original Sam Smith copyright on unzip
2.0, upon which Info-ZIP's UnZip 3.0 was based; Igor Mandrichenko's copyright
on his routines in vms.c; and Greg Roelofs' copyright on the new version of
unshrink.c.  In addition, Mark Adler has placed inflate.h, inflate.c, explode.c
and funzip.c into the public domain; i.e., these files may be used without any
restrictions beyond those of simple courtesy (credit where it's due). All of
these are discussed immediately below; the Frequently Asked Questions regarding
(re)distribution of Zip and UnZip are near the end of this file.

The original unzip source code has been extensively modified and mostly
rewritten (changes include random zipfile access rather than sequential;
replacement of unimplode() with explode(); replacement of output routines;
addition of inflate(), wildcards, filename- mapping, text translation, ...;
etc.).  As far as we can tell, the only remaining code which is substantially
similar to Mr. Smith's is that in the files unreduce.c and the old version of
unshrink.c (although even those have been modified), to which the following
copyright therefore applies:

          * Copyright 1989 Samuel H. Smith;  All rights reserved
          *
          * Do not distribute modified versions without my permission.
          * Do not remove or alter this notice or any other copyright notice.
          * If you use this in your own program you must distribute source code.
          * Do not use any of this in a commercial product.

 Regarding the first stipulation, Mr. Smith was finally tracked down in
 southern California [Samuel H. Smith, The Tool Shop, P.O. Box 8808, Panorama
 City, CA  91412-4808, [phone] (voice), [phone] (BBS, 2400 baud,
 free access)]  [ADDITIONAL NOTE, July 1994:  he's moved again, as of mid-May
 1994; these numbers are no longer correct]:

 "He says that he thought that whoever contacted him understood that he has no
 objection to the Info-ZIP group's inclusion of his code. His primary concern
 is that it remain freely distributable, he said."

 Info-ZIP is indebted and grateful to Mr. Smith; we hope he finds our
 contributions as useful as we have his.

 Note that the third and fourth stipulations still apply to any company which
 wishes to incorporate the unreduce and/or "old" unshrink code into its
 products; if you wish to do so, you must contact Mr. Smith regarding
 licensing.

 The following copyright applies to most of the VMS code in vms.c, distributed
 with UnZip versions 4.2 and later:

          * Copyright (C) 1992 Igor Mandrichenko.
          * Permission is granted to any individual or institution to use,
          * copy, or redistribute this software so long as all of the orig-
          * inal files are included unmodified, that it is not sold for
          * profit, and that this copyright notice is retained.

 The following copyright applies to the new version of "unshrink" in
 unshrink.c, distributed with UnZip versions 5.11 and later:

          * Copyright (C) 1994 Greg Roelofs.
          * Permission is granted to any individual/institution/corporate
          * entity to use, copy, redistribute or modify this software for
          * any purpose whatsoever, subject to the conditions noted in the
          * Frequently Asked Questions section below, plus one additional
          * condition:  namely, that my name remain attached to the source
          * code.  (Other names may, of course, be added as modifications
          * are made.)  Corporate legal staff (like at IBM :-) ) who have
          * problems understanding this can contact me through zip-bugs...

 The remaining code was written by many people associated with the Info-ZIP
 group, with large contributions from (but not limited to): Mark Adler
 (inflate, explode, funzip), Kai Uwe Rommel (OS/2), John Bush and Paul Kienitz
 (Amiga), Antoine Verheijen (Macintosh), Hunter Goatley (more VMS) and Greg
 Roelofs (lots of stuff).  See the file CONTRIBS in the source distribution for
 a much more complete list of contributors.  As noted above, Mark Adler's
 inflate.[ch], explode.c and funzip.c are in the public domain.  As for the
 remaining code, while it may not be explicitly copyrighted, we do request that
 no one else try to copyright it, either.  In other words, use it with our
 blessings, but it's still our code.  (You can consider that an implicit
 copyright if it makes you feel better. :-) )  Thank you!

 Frequently Asked Questions about distributing Zip and UnZip

 Q. Can I distribute Zip and UnZip sources and/or executables?

 A. You may redistribute the latest official distributions without any
 modification, and without even asking us for permission. [Note that an
 "executable distribution" includes documentation, even if it's in a separate
 zipfile; plain executables do NOT count.]  You can charge for the cost of the
 media (CDROM, diskettes, etc.) and a small copying fee.  Distributed archives
 should follow the naming conventions used in the Where file. If you want to
 distribute modified versions please contact us at [e-mail]
 first. You must not distribute beta versions without explicit permission to do
 so.

 Q. Can I use the executables of Zip and UnZip to distribute my software?

 A. Yes, so long as it is clear that Zip and UnZip are not being sold, that the
 source code is freely available, and that there are no extra or hidden charges
 resulting from its use by or inclusion with the commercial product.  Here is
 an example of a suitable notice:

          NOTE:  <Product> is packaged on this CD using Info-ZIP's
          compression utility.  The installation program uses UnZip
          to read zip files from the CD.  Info-ZIP's software (Zip,
          UnZip and related utilities) is free and can be obtained
          as source code or executables from various bulletin board
          services and anonymous-ftp sites, including CompuServe's
          IBMPRO forum and ftp.uu.net:/pub/archiving/zip/*.

 Q. Can I use the source code of Zip and UnZip in my commercial application?

 A. Yes, so long as you include in your product an acknowledgment and an offer
 of the original compression sources for free or for a small copying fee, and
 make clear that there are no extra or hidden charges resulting from the use of
 the compression code by your product (see below for an example).  The
 acknowledgment should appear in at least one piece of human-readable
 documentation (e.g., a README file or man page), although additionally putting
 it in the executable(s) is OK, too.  In other words, you are allowed to sell
 only your own work, not ours--and we'd like a little credit. [Note the
 additional restrictions above on the code in unreduce.c, unshrink.c and
 vms.c.]  Contact us at [e-mail] if you have special
 requirements.  We also like to know when our code is being used, but we don't
 require that.

          <Product> incorporates compression code by the Info-ZIP group.
          There are no extra charges or costs due to the use of this code,
          and the original compression sources are freely available from
          CompuServe in the IBMPRO forum and by anonymous ftp from the
          Internet site ftp.uu.net:/pub/archiving/zip.  We will also, upon
          request, mail you the full sources on a 3.5" MSDOS-format disk-
          ette for the cost of mailing.  Send $2.00 to <address> and ..."


ΓòÉΓòÉΓòÉ 1.4. About Gibbon Computer Products, Inc. ΓòÉΓòÉΓòÉ

Gibbon Computer Products, Inc. (GCP) is a small company founded in 1994 by John
C. Frickson.  In January of 1995 this became a full-time operation.

The goal at GCP is to provide quality software for the IBM OS/2 operating
system.  If you use any of the packages from GCP, please register them.  Your
support is needed for GCP to stay in business.  This plea also goes for any
other shareware package you use.  Many small businesses and individuals who
created good software have ceased doing so due to lack of support.

GCP currently has several products available and is working on others. While we
think we have some pretty good ideas, your input as to what kinds of software
you would like to see is always welcome.  See the Contact Information section
for various ways to communicate with GCP, and for ways to get information about
other software packages produced by GCP.


ΓòÉΓòÉΓòÉ 1.5. Contact and Product Information ΓòÉΓòÉΓòÉ

Contact Information

Gibbon Computer Products, Inc. can be contacted in a variety of ways.  The
information presented below may change in the future, so more current
documentation will be more likely to have accurate information.

 U.S. Mail

                                          Gibbon Computer Products, Inc.
                                          9864 Palm Street NW
                                          Coon Rapids, MN 55433
                                          USA

 Telephone           [phone]

 Internet EMail

                                          [e-mail] (for support and information)
                                          [e-mail] (John C. Frickson, President)

 FTP                 ftp.gibbon.com

 WWW                 http://www.gibbon.com/

 Gopher              gopher.gibbon.com

 Product Information

 A catalog of current products is available via ftp as /pub/gcp/catalog or from
 the WWW server as http://www.gibbon.com/catalog.

 The status of projects currently being worked on is available from the WWW
 server.  The URL is  http://www.gibbon.com/projects.html

 FAQs

 While this documentation is pretty complete, there are still questions and
 problems that sometimes come up.  When this happens, the answers are gathered
 together and put into a FAQ (Frequently Asked Questions document.) These FAQs
 can be accessed from both the FTP server the the directory /pub/gcp/faq and
 from the Web server at http://www.gibbon.com/faq. If you have any questions or
 problems, you should check for a FAQ.  The answers you seek may have already
 been answered.

 Mailing Lists

 There are also two mailing lists available.

 gibbon              The gibbon list is an open, unmoderated list.  It is a
                     list for users of GCP products and other interested
                     parties, where people can ask questions, share ideas, and
                     get support.

                     To subcribe, send EMail to [e-mail] and
                     have the word subscribe as the body of the message.

 gibbon_announce     The gibbon_announce list is an open list.  Anyone can
                     subscribe, but it is for information only, and only Gibbon
                     Computer Products, Inc. can post messages to the list.
                     The purpose of this list is for announcements of new
                     products, updates to existing products, bugs in currently
                     released products, beta test programs, and other
                     information of interest to the users of GCP software.

                     To subcribe, send EMail to
                     [e-mail] and have the word
                     subscribe as the body of the message.


ΓòÉΓòÉΓòÉ 1.6. Shareware Registration ΓòÉΓòÉΓòÉ

This is shareware, not freeware.  You may use this program for a trial period
to determine if you like it and if it suits your needs.  The trial period is
defined as thirty days. Use beyond this trial period is prohibited without
registering the software.

Warning: Once the trial period has passed, this program will no longer function.

 A registration form has been included in the package.  When you have sent in
the form along with payment, you will receive a Registration Reply Form with
your name and serial numbers, and instructions on how to brand the software
with this information.

At the time this is being written (April 30, 1996) Gibbon Computer Products,
Inc. is able to accept payment in the following ways:

     o A check in U.S. funds drawn on a U.S. bank or a branch of a U.S. bank.
     o An International Money Order
     o VISA, MasterCard and American Express


ΓòÉΓòÉΓòÉ 2. Groups and Servers Window ΓòÉΓòÉΓòÉ

The Gibbon FTP Groups and Servers window is the first window that appears when
the program starts.

The servers can be organized in a way similar to files on a disk drive. The
Groups folders are similar to directories.  They contain the Servers. You can
have multiple groups and subgroups (or child groups) in order to organize the
servers and make them easy to find.

For example, you could create a top-level John's Groups group. Then create the
child groups OS/2, IBM and Linux. With this type of organization, you would
know exactly where to find the server for getting program updates from IBM.

The window looks similar to many file managers.  The Groups window is on the
left.  The Groups are shown in Tree view, the way file managers show drives and
directories.  The Servers window is on the right.  The Servers can be show in
Icon view, Name view, Text view or Details view.

See also:

 Group Window
 Server Window
 FTP Session Window
 Settings
 Creating new groups
 Creating new servers


ΓòÉΓòÉΓòÉ 2.1. Groups Window ΓòÉΓòÉΓòÉ

The Groups Window contains group folders that you can use to organize servers
in a way similar to files on a disk drive.  The Groups folders are similar to
directories.  They contain the Servers.  You can have multiple groups and
subgroups (or child groups) in order to organize the servers and make them easy
to find.

For example, you could create a top-level John's Groups group. Then create the
child groups OS/2, IBM and Linux. With this type of organization, you would
know exactly where to find the server for getting program updates from IBM.

See also:

 Group Pop-up Menus
 Groups and Servers Window
 Server Window
 FTP Session Window
 Settings


ΓòÉΓòÉΓòÉ 2.1.1. Group Pop-up Menus ΓòÉΓòÉΓòÉ

The Group window has two pop-up menus available.  They are both displayed by
clicking mouse button 2, which is usually the right mouse button unless you
have OS/2 configured for a left-haded mouse.

One menu, the Container Menu, is displayed when you click mouse button 2 on an
empty area of the window.  This menu has the following menu items:

     Create Group
     View
     Transfer Queue
     General Settings

 The other menu, the Object Menu, is displayed when you click mouse button 2
 when the mouse is over a group folder.  This menu has the following menu
 itmes:

     Delete Group
     Create Child Group


ΓòÉΓòÉΓòÉ 2.1.1.1. Create Group ΓòÉΓòÉΓòÉ

The Create Group menu item is used to create a new server group. The new group
that is created will be a top-level group, not a child of another group.


ΓòÉΓòÉΓòÉ 2.1.1.2. View ΓòÉΓòÉΓòÉ

The View menu item is used to set how the server groups are displayed in the
Groups window.  This is a submenu that contains the following menu items:

 Icon           Sets the container to Icon Tree view.  Folder icons will be
                displayed to the left of the group name.

 Text           Sets the container to Text Tree view.  No icons will be
                displayed next to the group name.

 Mini Icons     This option is only enabled if Icon view is selected.
                Selecting Mini Icons will cause the folder icon to be smaller.


ΓòÉΓòÉΓòÉ 2.1.1.3. Transfer Queue ΓòÉΓòÉΓòÉ

The Transfer Queue menu item appears in the Groups and Servers pop-up menus,
the Windows menu in the session window, and the button bar in the session
window.  When this is selected, the Transfer Queue window will be dispayed if
it is currently hidden, or hidden if it is currenly being displayed.


ΓòÉΓòÉΓòÉ 2.1.1.4. General Settings ΓòÉΓòÉΓòÉ

The General Settings menu item appears in the Groups and Servers pop-up menus,
and the Server menu in the session window.  When this is selected, the General
Settings notebook will be dispayed.


ΓòÉΓòÉΓòÉ 2.1.1.5. Delete Group ΓòÉΓòÉΓòÉ

The Delete Group menu item is used to delete a server group. If the group you
are trying to delete contains child groups, you will not be permitted to delete
the group.  You must first either move the child groups to another group, or
delete the child groups.

Warning: If you delete a group, any servers in that group will also be deleted.


ΓòÉΓòÉΓòÉ 2.1.1.6. Create Child Group ΓòÉΓòÉΓòÉ

The Create Child Group menu item is used to create a new group that is a child
of the selected group.  If you think of a group as a directory on a disk drive,
a child group would be similar to a subdirectory.  Both the parent and child
groups can contain servers.


ΓòÉΓòÉΓòÉ 2.2. Servers Window ΓòÉΓòÉΓòÉ

The Servers window shows the FTP servers in the currently selected group.  The
Servers can be shown in Icon view, Name view, Text view or Details view.

In all views except Details view, the server shows an alias instead of the
hostname.  An alias is often both shorter and more meaningful than a hostname.
For example, OS/2 Updates as an alias is better than ftp01.ny.us.ibm.net.

You can also have more than one server set up for an ftp site, each with a
different alias and different settings.  You could, for example, have two
servers defined, both of which connect to hobbes.nmsu.edu.  One might have an
alias of Hobbes Incoming and the settings would have a default directory of
/incoming.  The other might have an alias of Hobbes TCPIP and the settings
would have a default directory of /os2/network/tcpip.

See also:

 Server Pop-up Menus
 Groups and Servers Window
 Group Window
 FTP Session Window
 Settings


ΓòÉΓòÉΓòÉ 2.2.1. Server Pop-up Menus ΓòÉΓòÉΓòÉ

The FTP Server window has two pop-up menus available.  They are both displayed
by clicking mouse button 2, which is usually the right mouse button unless you
have OS/2 configured for a left-haded mouse.

One menu, the Container Menu, is displayed when you click mouse button 2 on an
empty area of the window.  This menu has the following menu items:

     Create Server
     View
     Sort
     Transfer Queue
     General Settings

 The other menu, the Object Menu, is displayed when you click mouse button 2
 when the mouse is over a server object.  This menu has the following menu
 itmes:

     Connect
     Ping Server
     Settings
     General Settings
     Delete
     Copy


ΓòÉΓòÉΓòÉ 2.2.1.1. Create Server ΓòÉΓòÉΓòÉ

The Create Server menu item is used to create a new server object in the
currently selected group.


ΓòÉΓòÉΓòÉ 2.2.1.2. View ΓòÉΓòÉΓòÉ

The View menu item is used to set how the servers are displayed in the Servers
window.  This is a submenu that contains the following menu items:

 Icon           Sets the container to Icon view.  The Server Alias will be
                displayed below a server icon.

 Name           Sets the container to Name view.  The Server Alias will be
                displayed to the right of a server icon.

 Text           Sets the container to Text view.  No icons will be displayed.
                Only the alias will be shown.

 Details        Sets the container to Details view.  The details view display
                has four columns.  The first column contains the Alias.  The
                second column contains the hostname or IP address.  The third
                and fourth columns contain the date and time this server was
                used.

 Flowed         This option is only available if Name or Text view is selected.
                In Name and Text view, the items appear in a single column, and
                a scroll bar is on the right side of the window.  When Flowed
                is also selected, then the items appear in multiple columns,
                each column filled with as many items as will fit vertically in
                the window.  The scroll bar is on the bottom of the window and
                it allows you to scroll other columns into view.

 Mini Icons     This option is only enabled if Icon or Name view is selected.
                Selecting Mini Icons will cause the server icon to be smaller.


ΓòÉΓòÉΓòÉ 2.2.1.3. Sort ΓòÉΓòÉΓòÉ

The Sort menu item is used to set how the servers are displayed in the Servers
window.  This is a submenu that contains the following menu items:

 Alias          The Servers in the window are sorted by the server Alias.

 Hostname       The Servers in the window are sorted by the hostname or IP
                address of the server.

 Access Date    The Servers in the window are sorted by the last Access Date.

 Descending     Reverses the sort order.  For Alias or Hostname, the servers
                would be sorted in descending alphanumeric sequence.  For
                Access Date, the server with the most recent access date would
                appear first.


ΓòÉΓòÉΓòÉ 2.2.1.4. Transfer Queue ΓòÉΓòÉΓòÉ

The Transfer Queue menu item appears in the Groups and Servers pop-up menus,
the Windows menu in the session window, and the button bar in the session
window.  When this is selected, the Transfer Queue window will be dispayed if
it is currently hidden, or hidden if it is currenly being displayed.


ΓòÉΓòÉΓòÉ 2.2.1.5. General Settings ΓòÉΓòÉΓòÉ

The General Settings menu item appears in the Groups and Servers pop-up menus,
and the Server menu in the session window.  When this is selected, the General
Settings notebook will be dispayed.


ΓòÉΓòÉΓòÉ 2.2.1.6. Connect ΓòÉΓòÉΓòÉ

The Connect menu item is used to start a session with the ftp server.  When you
select the Connect menu item, the session window will be displayed, and the
connection and logon sequence will start.


ΓòÉΓòÉΓòÉ 2.2.1.7. Ping Server ΓòÉΓòÉΓòÉ

The Ping Server menu item can be used to find out if the ftp server is online
and available.  When you select the Ping Server menu item, a dialog will
appear.  After a short time (anywhere from less than one second to several
seconds) it will display the results.  If the server responds to the Ping, the
dialog will report that the server is alive.  If the server does not respond,
the dialog will report that the server is not alive.


ΓòÉΓòÉΓòÉ 2.2.1.8. Settings ΓòÉΓòÉΓòÉ

The Settings menu item appears in the Servers window pop-up menu, the Server
menu in the session window, and the button bar in the session window.  When
this is selected, the Settings notebook for the server will be dispayed.


ΓòÉΓòÉΓòÉ 2.2.1.9. Delete ΓòÉΓòÉΓòÉ

The Delete menu item is used to delete a server.


ΓòÉΓòÉΓòÉ 2.2.1.10. Copy ΓòÉΓòÉΓòÉ

The Copy menu item is used to create a new server in the currently selected
group.  The settings for the new server will default to the settings of the
server from which you are copying.


ΓòÉΓòÉΓòÉ 3. FTP Session Window ΓòÉΓòÉΓòÉ

The Gibbon FTP Session window is the window that appears when you start an FTP
session with a server, by double-clicking on a server in the Groups and Servers
window, or selecting Connect from the pop-up menu.  The title bar includes the
name of the server.

The window looks similar to many file managers.  By default, it contains four
windows: the Remote Directory window in the upper left, the Remote File window
in the upper right, the Local Directory window in the lower left, and the Local
File window in the lower right.

In addition, it contains a menu bar, an optional button bar, a status line, and
a drag-and-drop server icon in the title bar.

See also:

 Session Menus and Button Bar
 Session Titlebar Icon
 Remote Directory Window
 Remote File Window
 Local Directory Window
 Local File Window
 Groups and Servers Window


ΓòÉΓòÉΓòÉ 3.1. Session Menu and Button Bar ΓòÉΓòÉΓòÉ

The FTP Session Window has a menu bar across the top of the window.  The menu
items are used for controlling and getting information about the server,
setting options, and displaying other windows.

The optional button bar has buttons for several common tasks.

See also:

 Session Menu Bar
 Session Button Bar


ΓòÉΓòÉΓòÉ 3.1.1. Session Menu Bar ΓòÉΓòÉΓòÉ

The FTP Session Window has a menu bar across the top of the window.  The menu
items are used for controlling and getting information about the server,
setting options, and displaying other windows.

See also:

 Server Menu
 Options Menu
 Windows Menu


ΓòÉΓòÉΓòÉ 3.1.1.1. Server Menu ΓòÉΓòÉΓòÉ

The Server menu contains menu items that are used for connecting to or
disconnecting from the server, getting information about the server, sending
non-standard commands, and displaying settings notebooks.  The menu items are
described below.

Connect/Disconnect

If an FTP session is currently active, this menu item will close the session,
but will not close the session window.  If a session is not active, it will
attempt to connect to the remote server.

Ping

Selecting this menu item will send a PING packet to the remote server and
display the results in a dialog box.  This can be used, for example, when you
are not getting a response from the server to determin if the server is
offline, or is simply slow.

Server Information

When this menu item is selected, a dialog will be displayed that contains
information about the server.  Gibbon FTP can often tell what type of system
the remote server is (for example, Unix, VMS, OS/2, MVS, etc.) and it will
display this information.

QUOTE command

Selecting this menu item will display a dialog box where you can enter manual
commands that are sent to the remote FTP server.  You can see the result of the
command in the Trace Log window.  For example, you could enter STAT and the
remote server will respond with the current status. QUOTE command are standard
FTP protocol commands.  You can get a list of valid commands by entering HELP.

SITE command

Selecting this menu item will display a dialog box where you can enter manual
commands that are sent to the remote FTP server.  You can see the result of the
command in the Trace Log window.  For example, you could enter EXEC ls -l on
most Unix servers and the remote server will respond with a directory listing
of the current directory.  SITE command are not standard FTP protocol commands
and are dependant on the implementation of the server.  You can get a list of
valid commands by entering HELP.

Settings

Selecting this menu item will cause the settings notebook for the current
server to be activated.

General Settings

Selecting this menu item will cause the General Settings notebook to be
activated.


ΓòÉΓòÉΓòÉ 3.1.1.2. Options Menu ΓòÉΓòÉΓòÉ

The Options menu contains menu items that are used for changing the default
options that are set up in the settings notebook.  The menu items are described
below.

ASCII Transfer mode

Selecting this menu item will cause the default transfer mode to be set to
ASCII.  Files transfered in ASCII mode will ensure each line ends with both a
Carriage Return and a Line Feed.  In addition, if the remote system uses a
character set other than ASCII, such as MVS and VM systems which use EBCDIC,
the file will be translated to ASCII when it is downloaded, or to EBCDIC when
it is uploaded.  Selecting ASCII mode for transfering binary files, such as
programs or ZIP files will cause these file to become corrupt, so use this mode
with caution.

This setting will be overridden by the File Type list in the General Settings
notebook.

Binary Transfer mode

Selecting this menu item will cause the default transfer mode to be set to
Binary.  Files transfered in Binary (or Image) mode will be transferred exactly
as they are on the remote system when they are download, or as they are on your
system when they are uploaded.

This setting will be overridden by the File Type list in the General Settings
notebook.

Confirm local deletes

When this item is selected, if you delete a local file, a confirmation message
will be displayed.

Unique local names

When this item is selected, if you download a file, and a file with the same
name already exists, a unique name will be assigned.  For example, if you
download a file named README.NOW and there is already a file with that name on
your system, the new file will be called README.NO0.  Then next time you
download the file, it will be called README.NO1.

When this option is selected, you will not be able to select the Confirm local
overwrites item since these two would conflict.

Confirm local overwrites

When this item is selected, if you download a file, and a file with the same
name already exists, a confirmation message will be displayed.  You can tell it
to cancel the transfer, overwrite the file, or restart the transfer. The
restart feature would be used if a previous transfer stopped before it was
finished.  This will allow you to start the transfer where it left off.

Confirm remote deletes

When this item is selected, if you delete a remote file, a confirmation message
will be displayed.

Unique remote names

When this item is selected, any files you upload to the remote server will have
a unique name, so it will not overwrite any existing files.

Set timestamp on GET

When you download a file from a remote server, the file normally ends up having
the date and time the file was downloaded.  When this item is selected, the
date and time on the file will be changed to match the date and time on the
file as it was on the server.


ΓòÉΓòÉΓòÉ 3.1.1.3. Windows Menu ΓòÉΓòÉΓòÉ

The Windows menu contains menu items that are used for displaying other
windows, such as the Groups and Servers window, or the Transfer Queue.  The
menu items are described below.

Display local directories

When this item is selected, the local directory and file windows will be
displayed.  If this item is deselected, the local directory and file windows
will be hidden.  Hiding the local windows will provide more room to display the
remote directory contents.  The General Settings notebook contains an option to
set the default status of the local windows.

Server selection window

This is used to display the Groups and Servers window.  If that window is
minimized, it will be restored and broght to the top.

Next session

This is used to cycle through various session windows if you have multiple
sessions active.  If the next session window in the sequence has been
minimized, it will be restored and brought to the top.

Transfer Queue

Selecting this menu item will cause the Transfer Queue window to be displayed.
Deselecting it will case the Transfer Queue window to be hidden.

Transfer Status

Selecting this menu item will cause the Transfer Status window to be displayed.
Deselecting it will case the Transfer Status window to be hidden.

Server Messages

Selecting this menu item will cause the Server Messages window to be displayed.
Deselecting it will case the Server Messages window to be hidden. This item
will be disabled if there are no messages.

Trace Log

Selecting this menu item will cause the Trace Log window to be displayed.
Deselecting it will case the Trace Log window to be hidden.


ΓòÉΓòÉΓòÉ 3.1.2. Session Button Bar ΓòÉΓòÉΓòÉ

The button bar has buttons for several common tasks.  It is optional and can be
enabled or disabled from the General Settings notebook.  It has the following
buttons:

      This button will close the connection to the remote server if it is
     active, and close the session window.

      This button will close the connection to the remote server is active, or
     initiate a new connection.

      This button will change the default transfer mode to ASCII.  The default
     transfer mode is used for any file that is not defined in the File Types
     list in the General Settings notebook.

      This button will change the default transfer mode to Binary.  The default
     transfer mode is used for any file that is not defined in the File Types
     list in the General Settings notebook.

      This button will add the selected local files to the Transfer Queue to be
     uploaded to the server.

      This button will add the selected remote files to the Transfer Queue to
     be downloaded from the server.

      This button will add the selected remote files to the Transfer Queue to
     be downloaded from the server, and viewed using either the internal
     viewer, or an external viewer.  The choice of viewers is made by using the
     File Types list in the General Settings notebook.

      This button will refresh the remote file list for the current directory.

      This button will show or hide the local directory and file windows.

      This button will show or hide the Transfer Status window.

      This button will show or hide the Transfer Queue window.

      This button will show or hide the Server Messages window.

      This button will show or hide the Trace window.

      This button will bring up the How do I... section of the online help.


ΓòÉΓòÉΓòÉ 3.2. Remote Directory Window ΓòÉΓòÉΓòÉ

The Remote Directory window displays a list of directories on the server. They
are shown in similar to the way directories are displayed in the OS/2

This window does not display the full directory tree.  On many servers, it
would take too long to get a complete list, so only the current directory, its
parent directories and its immediate subdirectories are displayed initially.
As you enter other directories, the tree will fill out.

If you have this window set to display Icons or Mini Icons, the Icons will
change depending on the status of the directory.  If you have not yet changed
to a particular directory, its contents are not yet known, so its icon is a
folder with a question mark.  The contents of the current directory and any
other directory that is in the cache is known, so those icons will be a  folder
with a check mark.  You occasionally will find directories that you do not have
permission to view.  When you attempt to change to these directories, the
server will send back a message telling you that you don't have permission.
When this happens, the icon for that directory will change to a  no permission
folder.

See also:

 Remote Directory Container Menu
 Remote Directory Item Menu


ΓòÉΓòÉΓòÉ 3.2.1. Remote Directory Container Menu ΓòÉΓòÉΓòÉ

This pop-up menu is displayed when mouse button 2 is pressed while the mouse
pointer is over an empty area of the Remote Directory window.  This menu
contains the following:

 Change to directory
 View


ΓòÉΓòÉΓòÉ 3.2.1.1. Change to directory ΓòÉΓòÉΓòÉ

When this menu item is selected, a dialog will be displayed where you can enter
the name of a directory.  The name you enter will become the current directory
on the remote server.  This normally works best if you enter the full path.
For example, on a Unix system, if you are currently in the /pub directory, you
should enter /pub/os2 to change to the /pub/os2 directory, not just os2.


ΓòÉΓòÉΓòÉ 3.2.1.2. View ΓòÉΓòÉΓòÉ

The View menu item is used to set how the directories are displayed in the
window.  This is a submenu that contains the following menu items:

 Icon View      Sets the container to Icon Tree view.  Folder icons will be
                displayed to the left of the directory name.

 Text View      Sets the container to Text Tree view.  No icons will be
                displayed next to the directory name.

 Mini Icons     This option is only enabled if Icon view is selected.
                Selecting Mini Icons will cause the folder icon to be smaller.


ΓòÉΓòÉΓòÉ 3.2.2. Remote Directory Item Menu ΓòÉΓòÉΓòÉ

This pop-up menu is displayed when mouse button 2 is pressed while the mouse
pointer is over a directory entry in the Remote Directory window.  This menu
contains the following:

 Create Directory
 Delete Directory
 Rename Directory


ΓòÉΓòÉΓòÉ 3.2.2.1. Create Directory ΓòÉΓòÉΓòÉ

This menu item is used to create a directory on the remote server.  When
selected, a dialog box will appear where you can enter the name of the
directory you want to create.


ΓòÉΓòÉΓòÉ 3.2.2.2. Delete Directory ΓòÉΓòÉΓòÉ

This menu item is used to delete the directory on the remote server.


ΓòÉΓòÉΓòÉ 3.2.2.3. Rename Directory ΓòÉΓòÉΓòÉ

This menu item is used to rename the directory on the remote server.  When
selected, a dialog box will appear where you can enter the new name of the
directory.


ΓòÉΓòÉΓòÉ 3.3. Remote File Window ΓòÉΓòÉΓòÉ

The Remote File window displays a list of files in a directory on the server.
The files are displayed similar to the way OS/2 displayes files, giving you an
option of Icon view, Details view, etc.

See also:

 Remote File Container Menu
 Remote File Item Menu


ΓòÉΓòÉΓòÉ 3.3.1. Remote File Container Menu ΓòÉΓòÉΓòÉ

This pop-up menu is displayed when mouse button 2 is pressed while the mouse
pointer is over an empty area of the Remote Files window.  This menu contains
the following:

 Refresh Directory
 Download file
 View
 Sort


ΓòÉΓòÉΓòÉ 3.3.1.1. Refresh Directory ΓòÉΓòÉΓòÉ

When this menu item is selected, a list of files in the current directory will
be requested from the server, and the file list in the window will be
refreshed.


ΓòÉΓòÉΓòÉ 3.3.1.2. Download file ΓòÉΓòÉΓòÉ

When this menu item is selected, a dialog will be displayed where you can enter
a filename to be downloaded.  This would normally be used only if Gibbon FTP
was unable to determine the remote server type, and therefore displays the file
list without breaking out the filename.  In this case, Gibbon FTP does not know
what the filename is, and you might have to enter it manually.


ΓòÉΓòÉΓòÉ 3.3.1.3. View ΓòÉΓòÉΓòÉ

The View menu item is used to set how the files are displayed in the window.
This is a submenu that contains the following menu items:

 Icon           Sets the container to Icon view.  The file name will be
                displayed beneath an icon.

 Name           Sets the container to Name view.  The file name will be
                displayed to the right of the icon.

 Text           Sets the container to Text view.  No icons will be displayed.
                Only the file name will be shown.

 Details        Sets the container to Details view.  The details view display
                has several columns.  The columns that are displayed depend on
                the remote server.  For Unix servers, which are the most
                common, the columns are: Title, Link Name, Size, Date, Time,
                Attributes, Owner and Group.. OS/2, NT, DOS and similar servers
                don't have the Link Name, Owner or Group. columns.  MVS, VM,
                and VMS servers are almost completely different, since the
                information available from the server is different.  On some
                systems, for example, the file size is not available as a byte
                count, but rather as a block count.

 Flowed         This option is only available if Name or Text view is selected.
                In Name and Text view, the items appear in a single column, and
                a scroll bar is on the right side of the window.  When Flowed
                is also selected, then the items appear in multiple columns,
                each column filled with as many items as will fit vertically in
                the window.  The scroll bar is on the bottom of the window and
                it allows you to scroll other columns into view.

 Mini Icons     This option is only enabled if Icon or Name view is selected.
                Selecting Mini Icons will cause the icon to be smaller.


ΓòÉΓòÉΓòÉ 3.3.1.4. Sort ΓòÉΓòÉΓòÉ

The Sort menu item is used to set how the files are sorted in the window.  This
is a submenu that contains the following menu items:

 File Name      Sorts the entries by File Name or Title.

 Date and Time  Sorts the entries by Date and Time

 File Size      Sorts the entries by the file size.

 Descending     If this is selected, the corresponding sort (File Name, Date
                and Time, or File Size) is in descending instead of ascending
                sequence.  This is particularly useful with Date and Time in
                order to have recent files at the top.  This is a good way to
                check for new files in incoming directories.


ΓòÉΓòÉΓòÉ 3.3.2. Remote File Item Menu ΓòÉΓòÉΓòÉ

This pop-up menu is displayed when mouse button 2 is pressed while the mouse
pointer is over a file entry in the Remote Files window.  This menu contains
the following:

 Download File
 View File
 Restart Download
 Delete File
 Rename File


ΓòÉΓòÉΓòÉ 3.3.2.1. Download File ΓòÉΓòÉΓòÉ

Selecting this menu item will add the selected file(s) to the Transfer Queue to
be downloaded.


ΓòÉΓòÉΓòÉ 3.3.2.2. View File ΓòÉΓòÉΓòÉ

Selecting this menu item will add the selected file(s) to the Transfer Queue to
be download and viewed.  The file viewer to be used is determined by the File
Types entries in the General Settings notebook.  If no viewer is defined for
the file type being downloaded, you will be asked if you want to use the
internal viewer.


ΓòÉΓòÉΓòÉ 3.3.2.3. Restart Download ΓòÉΓòÉΓòÉ

Selecting this menu item is similar to doing a normal download, except the
download will be restarted.  This is useful if you were previously downloading
a large file, and the download didn't finish.  If the FTP server supports
restarts, the download will start where it left off, and only the remaining
portion of the file will be downloaded.


ΓòÉΓòÉΓòÉ 3.3.2.4. Delete File ΓòÉΓòÉΓòÉ

Selecting this menu item will cause the remote file to be deleted.


ΓòÉΓòÉΓòÉ 3.3.2.5. Rename File ΓòÉΓòÉΓòÉ

When this menu item is selected, a dialog box will be displayed where you can
enter the new name of the file.  The file will then be renamed on the remote
server.


ΓòÉΓòÉΓòÉ 3.4. Local Directory Window ΓòÉΓòÉΓòÉ

The Local Directory window displays a list of drives and directories on the
local system server.  They are shown in similar to the way directories are
displayed in the OS/2

This window does not display the full directory tree.  It would take too long
to get a complete list, and usually only a defined download directory is used,
so only the current directory, its parent directories and its immediate
subdirectories are displayed initially.  As you enter other directories, the
tree will fill out.

If you have this window set to display Icons or Mini Icons, the Icons used for
the drives will depend on the type of drive.  For a floppy drive, a  floppy
disk icon is used.  For a regular hard disk, a  hard disk icon is used.  For a
CDRom drive, a  CDRom icon is used. And for a network drive, a  network drive
icon is used.

See also:

 Local Directory Container Menu
 Local Directory Item Menu


ΓòÉΓòÉΓòÉ 3.4.1. Local Directory Container Menu ΓòÉΓòÉΓòÉ

This pop-up menu is displayed when mouse button 2 is pressed while the mouse
pointer is over an empty area of the Local Directory window.  This menu
contains the following:

 Create Directory
 View


ΓòÉΓòÉΓòÉ 3.4.1.1. Create Directory ΓòÉΓòÉΓòÉ

When this menu item is selected, a dialog will be displayed where you can enter
the name of a directory.  The name you enter will be used to create the new
directory.


ΓòÉΓòÉΓòÉ 3.4.1.2. View ΓòÉΓòÉΓòÉ

The View menu item is used to set how the directories are displayed in the
window.  This is a submenu that contains the following menu items:

 Icon View      Sets the container to Icon Tree view.  Folder icons will be
                displayed to the left of the directory name.

 Text View      Sets the container to Text Tree view.  No icons will be
                displayed next to the directory name.

 Mini Icons     This option is only enabled if Icon view is selected.
                Selecting Mini Icons will cause the folder icon to be smaller.


ΓòÉΓòÉΓòÉ 3.4.2. Local Directory Item Menu ΓòÉΓòÉΓòÉ

This pop-up menu is displayed when mouse button 2 is pressed while the mouse
pointer is over a drive or directory entry in the Local Directory window. This
menu contains the following:

 Create Directory
 Remove Directory
 Rename Directory


ΓòÉΓòÉΓòÉ 3.4.2.1. Create Directory ΓòÉΓòÉΓòÉ

This menu item is used to create a directory.  When selected, a dialog box will
appear where you can enter the name of the directory you want to create.


ΓòÉΓòÉΓòÉ 3.4.2.2. Remove Directory ΓòÉΓòÉΓòÉ

This menu item is used to delete the directory.


ΓòÉΓòÉΓòÉ 3.4.2.3. Rename Directory ΓòÉΓòÉΓòÉ

This menu item is used to rename the directory.  When selected, a dialog box
will appear where you can enter the new name of the directory.


ΓòÉΓòÉΓòÉ 3.5. Local File Window ΓòÉΓòÉΓòÉ

The Local File window displays a list of files in the current directory. The
files are displayed similar to the way OS/2 displays files, giving you an
option of Icon view, Details view, etc.

See also:

 Local File Container Menu
 Local File Item Menu


ΓòÉΓòÉΓòÉ 3.5.1. Local File Container Menu ΓòÉΓòÉΓòÉ

This pop-up menu is displayed when mouse button 2 is pressed while the mouse
pointer is over an empty area of the Local Files window.  This menu contains
the following:

 Refresh Directory
 View
 Sort


ΓòÉΓòÉΓòÉ 3.5.1.1. Refresh Directory ΓòÉΓòÉΓòÉ

When this menu item is selected, a list of files in the current directory will
be requested, and the file list in the window will be refreshed.


ΓòÉΓòÉΓòÉ 3.5.1.2. View ΓòÉΓòÉΓòÉ

The View menu item is used to set how the files are displayed in the window.
This is a submenu that contains the following menu items:

 Icon           Sets the container to Icon view.  The file name will be
                displayed beneath an icon.

 Name           Sets the container to Name view.  The file name will be
                displayed to the right of the icon.

 Text           Sets the container to Text view.  No icons will be displayed.
                Only the file name will be shown.

 Details        Sets the container to Details view.  The details view display
                has several columns.  The columns that are displayed are:
                Title, Real Name, Size, Date, Time and Attributes..

 Flowed         This option is only available if Name or Text view is selected.
                In Name and Text view, the items appear in a single column, and
                a scroll bar is on the right side of the window.  When Flowed
                is also selected, then the items appear in multiple columns,
                each column filled with as many items as will fit vertically in
                the window.  The scroll bar is on the bottom of the window and
                it allows you to scroll other columns into view.

 Mini Icons     This option is only enabled if Icon or Name view is selected.
                Selecting Mini Icons will cause the icon to be smaller.


ΓòÉΓòÉΓòÉ 3.5.1.3. Sort ΓòÉΓòÉΓòÉ

The Sort menu item is used to set how the files are sorted in the window.  This
is a submenu that contains the following menu items:

 Title          Sorts the entries by Title.

 Real Name      Sorts the entries by the real name (file name).

 Date and Time  Sorts the entries by Date and Time

 File Size      Sorts the entries by the file size.

 Descending     If this is selected, the corresponding sort (Title, Real Name,
                Date and Time, or File Size) is in descending instead of
                ascending sequence.


ΓòÉΓòÉΓòÉ 3.5.2. Local File Item Menu ΓòÉΓòÉΓòÉ

This pop-up menu is displayed when mouse button 2 is pressed while the mouse
pointer is over a file entry in the Local Files window.  This menu contains the
following:

 Upload File
 View File
 Delete File
 Rename File


ΓòÉΓòÉΓòÉ 3.5.2.1. Upload File ΓòÉΓòÉΓòÉ

Selecting this menu item will add the selected file(s) to the Transfer Queue to
be uploaded to the server.


ΓòÉΓòÉΓòÉ 3.5.2.2. View File ΓòÉΓòÉΓòÉ

Selecting this menu item will cause the file to be viewed using the internal
viewer.  Currently, the File Types list in the General Settings notebook is not
used to determine if an external program should be used to view the file.  Only
the internal viewer is used.


ΓòÉΓòÉΓòÉ 3.5.2.3. Delete File ΓòÉΓòÉΓòÉ

Selecting this menu item will cause the file to be deleted.


ΓòÉΓòÉΓòÉ 3.5.2.4. Rename File ΓòÉΓòÉΓòÉ

When this menu item is selected, a dialog box will be displayed where you can
enter the new name of the file.  The file will then be renamed.


ΓòÉΓòÉΓòÉ 3.6. Session Titlebar Icon ΓòÉΓòÉΓòÉ

There is a  Server icon in the title bar of the Session window.  It is located
between the system menu and the title. This is a dragable icon.  You can drag
this icon and drop it on the Servers Window, or on a Group Folder in the Groups
and Servers window.  This will create a new server.  The current local and
remote directories will be the default directories.  You will be asked for an
alias and a host name, but the host name will be filled in for you, though it
can be changed.

This was set up primarily to be used in two situations:

  1. If you used a Generic server to connect and decide you want to create a
     regular server entry.

  2. If you used a regular server entry to connect and decide you want another
     one that points to the same server, but with different defaults.


ΓòÉΓòÉΓòÉ 4. Server Message and Trace Log Windows ΓòÉΓòÉΓòÉ

For each active session, two additional windows are created, but are initially
hidden.  These are the Server Messages and Trace Log windows. The Server
Messages window can be displayed using the Server Messages menu item on the
Windows menu, or by using the  button on the button bar. The Trace Log window
can be displayed using the Trace Log menu item on the Windows menu, or by using
the  button on the button bar.

Both windows have a scrollable area for displaying messages, a Hide pushbutton,
and a Clear pushbutton.  The Hide pushbutton is used to hide the window.  The
Clear pushbutton is used to clear any existing information from the message
display area.

The Server Messages Window displayes informational messages that are received
from the FTP server.  These are normally received when you first connect to the
server, or the first time you enter a new directory.  These messages often
contain important information, such as instructions for downloading files,
pointers to README files, warnings about lack of disk space for incoming files,
or reasons why a login was unsuccessful.

Since these messages are often important, if there are any messages in the
Server Messages Window, the status line at the bottom of the Session window
will say There are messages to remind you to check the messages. The status
line will return to the normal Gibbon FTP Connected and Ready if you clear the
message window using the Clear pushbutton.

The Trace Log Window contains a record of the interaction between Gibbon FTP
and the remote server.  Most of the commands sent to the server and the replies
received are recorded in the Trace Log Window.  In most cases, the Trace Log
Window will never need to be displayed.  But it can be useful in certain
circumstances:

      1. If there is some problem, sometimes the trace log can help you figure
         out what is going wrong.

      2. If you use the QUOTE command or SITE command from the System menu, you
         will usually need to display the trace log to see the results.

      3. Gibbon FTP can handle firewall password challenges, such as S/Key, in
         some circumstances, but you may need to display the trace log to see
         the challenge.

      4. You might just be curious about how an FTP client and server talk to
         each other.

 The Trace Log Window normally does not show the incoming directory lists,
 because they are not usually important, and just waste memory.  If you need to
 see the directory list as it comes from the server, you can enable the logging
 of the list by adding the command line parameter: -d 1 when you start Gibbon
 FTP.


ΓòÉΓòÉΓòÉ 5. Transfer Queue Window ΓòÉΓòÉΓòÉ

All file transfers go through a transfer queue.  The Transfer Queue Window
shows a list of all transfers in the queue, and their status.

Here is a sample of how the Transfer Queue Window appears:

 Pause Transfer Queue This checkbox at the top is used to pause the queue.
                     When it is checked, no file transfers to or from any FTP
                     site will take place.

 File listbox        This shows the filenames of all files in the queue.  The
                     detail information below the listbox changes as different
                     files in the listbox are selected.

 FTP Site            This is the hostname or alias of the FTP site the file
                     will be sent to or received from.

 Local Directory     This is the directory on your machine.

 Remote Directory    This is the directory on the remote server.

 Actions             This will include either U/L for Upload or D/L for
                     Download.  It then shows the transfer mode, either ASCII
                     or Binary.  If the file is to be viewed, the Actions will
                     also include (View).  If the transfer is a restart, the
                     Actions will include (Restart).

 File Size           This is the size of the file to be transferred.

 Date and Time       This is the timestamp of the file to be transferred.

 Status              This shows the status of the file, and allows you to
                     change the status. Possible values are:

    Ready               The file is ready to be transferred.  The checkbox will
                        be unchecked.  If you click on the checkbox, it will
                        become checked and the status will change to Held.
    In Process          The file is currently being transferred.  The Status
                        field and the checkbox will be disabled.
    Held                The file is to be held in the queue, and will not be
                        transferred.  The checkbox will be checked.  If you
                        click on the checkbox, it will be unchecked and the
                        status will change to Ready
    Held (Failed)       A file transfer was attempted but failed for some
                        reason.  The checkbox will be checked.  If you click on
                        the checkbox, it will be unchecked, the status will
                        change to Ready and the transfer will be attempted
                        again.
    Held (Cancelled)    The file transfer was started, then was cancelled by
                        clicking on the Cancel Transfer pushbutton at the
                        bottom of the Transfer Status window.  The checkbox
                        will be checked.  If you click on the checkbox, it will
                        be unchecked, the status will change to Ready and the
                        transfer will be attempted again.
    Delete Pending      The Delete Entry pushbutton was pressed to delete this
                        file from the queue, but the entry has not been deleted
                        yet.  There can sometimes be a delay of several
                        seconds, but the entry will usually be deleted within
                        one or two seconds.

 Delete Entry        When this pushbutton is pressed, the currently hilighted
                     file in the listbox will be removed from the transfer
                     queue.


ΓòÉΓòÉΓòÉ 6. Transfer Status Window ΓòÉΓòÉΓòÉ

The Transfer Status window shows information about file transfers for a
particular session.  Here is a sample of how the Transfer Status Window
appears:

 Alias               The hostname or alias for the server is shown at the top
                     of the window.

 Current Transfer    This sections contains information about the file transfer
                     currently in progress.

    File Name           The name of the file being transferred.

    Filesize            The size of the file

    Bytes Transfered    The number of bytes that have been sent or received so
                        far.

    Elapsed Time        The amount of time the transfer has taken

    Time Remaining      The estimated time remaining for the transfer to
                        complete

    Transfer Rate       The speed of the file transfer in Characters Per Second
                        (CPS)

    Progress Bar        This is a graphical representation of how much of the
                        transfer has completed.

 Session Totals      This sections contains information about all file
                     transfers for this session

    Files Transfered    The number of files transferred and the total number of
                        files.  In the example above, five files were put into
                        the transfer queue, two have completed, the third file
                        is in process, and two remain.

    Total Bytes         The total number of bytes for all the files.

    Bytes Transfered    The total number of bytes transferred so far.  This
                        includes the number of bytes for completed transfers,
                        and the number of bytes transferred for the current
                        file.

    Elapsed Time        The total amount of time taken to transfer files so
                        far.

    Time Remaining      The estimated time it will take for all transfers to
                        complete

    Transfer Rate       The average speed of the file transfers in Characters
                        Per Second (CPS)

    Progress Bar        This is a graphical representation of how much of all
                        transfers has been completed.

 Notify when transfers complete (Not shown above)  This is a checkbox that is
                     immediately above the Cancel Transfer pushbutton.  If this
                     checkbox is checked, when all the transfers in the queue
                     have completed, a message box will be displayed to inform
                     you.

 Cancel Transfer     This pushbutton is used to cancel the file transfer that
                     is currently in progress.  When a transfer is cancelled,
                     the file will remain in the transfer queue so it can be
                     restarted later, if desired.


ΓòÉΓòÉΓòÉ 7. Gibbon FTP Settings Notebooks ΓòÉΓòÉΓòÉ

Gibbon FTP has two settings notebooks.  The General Settings Notebook is for
setting defaults and overall settings.  The Server Settings Notebook is for the
settings for servers.


ΓòÉΓòÉΓòÉ 8. General Settings Notebook ΓòÉΓòÉΓòÉ

This notebook is used to set default values, and for setting overall
configuration for Gibbon FTP.

The General Settings notebook contains these pages:

 Connect             sets the defaults for anonymous login, download directory,
                     connection retries, and two connections.

 Files               sets the defaults for transfer mode, unique file names,
                     timestamps, delete confirmations and directory cacheing.

 File Types          provides a user-modifiable list of file types that is used
                     to determine transfer mode and viewer.

 Window Colors       is used to set the colors for the windows.

 Window Fonts        is used to set the fonts for the windows.

 Window Other        has controls for showing or hiding the button bar, and for
                     showing or hiding the local file and directory windows.

 Firewall            is used to define how access through a firewall should be
                     handled.


ΓòÉΓòÉΓòÉ 8.1. Connect Notebook Page ΓòÉΓòÉΓòÉ

This page is used to set the defaults for anonymous login, download directory,
connection retries, and two connections.  It contains the following:

 Anonymous Login
 Connection Retries
 Attempt two Connections
 Default Download directory


ΓòÉΓòÉΓòÉ 8.1.1. Anonymous Login ΓòÉΓòÉΓòÉ

This groups of controls is used to set up the defaults for anonymous logins.

 Use literal below   This is the first radio button.  When selected, the
                     default anonymous password will be whatever is entered in
                     the Default Passwordentry field.

 Use Dialer email address This is the second radio button.  When selected, the
                     default anonymous password will be the email address
                     specified for the current Internet connection made using
                     the dialer.

 CLM User@hostname   This is the third radio button.  When selected, the
                     default anonymous password will be constructed using the
                     current user id as retrieved from the Common Login Manager
                     (CLM) and the current hostname.  If you do not have CLM
                     running, this radio button will be disabled.

 CLM User@domain     This is the fourth radio button.  When selected, the
                     default anonymous password will be constructed using the
                     current user id as retrieved from the Common Login Manager
                     (CLM) and the current domain name.  If you do not have CLM
                     running, this radio button will be disabled.

 Default Password    The contents of this entry field is used as the default
                     anonymous password if the first radio button, Use literal
                     below is selected.

 The Common Login Manager (CLM) mentioned is a program included with some
 applications from Gibbon Computer Products, Inc.  If you don't have CLM or
 don't know what it is, just ignore these radio buttons.


ΓòÉΓòÉΓòÉ 8.1.2. Connection Retries ΓòÉΓòÉΓòÉ

This groups of controls is used to set up the defaults for retries. Retries are
used when a login fails because the server is not on-line, or there are too
many users logged in.

 Do not retry        This is the first radio button.  When selected, retries
                     will be disabled.

 Always retry        This is the second radio button.  When selected, a failed
                     login will always be retried.

 Prompt for retry    This is the third radion button.  When selected, if a
                     login fails, a message box will be displayed asking you if
                     you want to retry.  If you respond with Yes then retries
                     will be attempted.

 Retry every .. Seconds This is a spin button that is used to set the amount of
                     time to wait between retries.  It is strongly recommended
                     that this be set no lower than 30 seconds.  Higher would
                     probably be better.  The wait time for specific servers
                     can be set lower if necessary, but the default in General
                     Settings should be higher.

 Stop after .. Tries This is a spin button that is used to set the maximum
                     number of times a login will be attempted before Gibbon
                     FTP gives up.


ΓòÉΓòÉΓòÉ 8.1.3. Attempt two Connections ΓòÉΓòÉΓòÉ

This is a checkbox that is used to set the default number of connections. If
this is checked, two connections will be attempted for each session.  The
second connection, if established, will be used to transfer files.  This keeps
the first connection free so you can continue to do other things while files
are being transferred.  You can, for example, change to other directories and
look for additional files to download.  Note that having only one connection
will not prevent you from looking at other directories and selecting files to
download if they are in the directory cache.

When two connections are requested, the status line at the bottom of the
session window will be split into two parts, one for each connection.

If you start transfering files before the second connection is established, the
second connection will take over and transfer any remaining files, so when the
transfer taking place on the first connection finishes, the first connection is
available for other tasks.


ΓòÉΓòÉΓòÉ 8.1.4. Default Download directory ΓòÉΓòÉΓòÉ

This is an entry field where you can enter the default download directory on
your system.


ΓòÉΓòÉΓòÉ 8.2. Files Notebook Page ΓòÉΓòÉΓòÉ

See the Files Notebook Page in the Server Settings Notebook section for details
about this page.


ΓòÉΓòÉΓòÉ 8.3. File Types ΓòÉΓòÉΓòÉ

This page is used to define or modify the File Type list.  This list is used
primarily when downloading a file from a remote server.  It determines the
transfer mode (ASCII or Binary), what the viewer is if the file is to be
viewed, if the file should always be viewed, and if the file should be kept
after viewing.

 File Type           This is a drop-down list box that is used to select a file
                     type.  The File Type list is a description of the file
                     type, and contains entries like Postscript and JPeg File.

 file Mask           This is the file mask that corresponds to the File Type.
                     Meta-characters (wild cards) can be used.  An asterisk (*)
                     is used to indicate any number of characters, and a
                     question mark (?) is used to indicate any single
                     character. These can be combined in a variety of ways,
                     either simple or complex.  You could have a file mask of
                     README.DOC that will only match the exact filename.  Or
                     you could have a file mask of *READ*.??? that would match
                     any file that has README anywhere in the name, and is
                     followed by a period and three other characters.

 File viewer         This is an entry field used to specify what program should
                     be used to view a downloaded file.  If this field contains
                     an asterisk (*) the internal viewer will be used.  If you
                     want to specify an external program, enter the program
                     name here.  If the program is noton the PATH, then you can
                     enter the full path.  You can also enter any command line
                     parameters that you normally use when starting the
                     program.  The characters %s  should be included on the
                     line.  When Gibbon FTP starts the program, it will include
                     the filename of the downloaded file where you put the %s
                     characters.

 ASCII transfer      Selecting this radio button indicates that this file type
                     should always be transferred using ASCII transfer mode.

 Binary transfer     Selecting this radio button indicates that this file type
                     should always be transferred using Binary (or Image)
                     transfer mode.

 Always use viewer   If this checkbox is checked, the defined file viewer
                     (either the internal viewer or an external program) will
                     always be used.  If it is not checked, a viewer will be
                     used to view the downloaded file only if you selected View
                     File from the popup menu to transfer the file, or if you
                     used the View button on the button bar.

 Keep file after viewing This checkbox is normally checked and disabled.  If
                     you set up the file type to use the internal viewer (by
                     putting an asterisk [*] in the File Viewer field) then
                     this checkbox will be enabled.  If it is not  checked, the
                     download will send the file to the internal viewer only
                     and will not write the file to your disk.

 Remove Type         This pushbutton is used to delete the selected file type
                     from the list.

 Add New Type        This pushbutton is used to add a new file type to the
                     list.  When pressed, a dialog will appear where you can
                     enter the file type.  This is a description of the type,
                     such as Plain Text or LZH Archive.  Make it descriptive,
                     but not too long.  After you enter the file type, it will
                     be added to the list and selected.  You can then set the
                     file mask, transfer type, and viewer.


ΓòÉΓòÉΓòÉ 8.4. Window Colors ΓòÉΓòÉΓòÉ

There are two ways to change the colors of various windows in Gibbon FTP. All
windows support the dropping of colors from OS/2 system color palettes. But
drag and drop of colors can only change the background and text colors. This
page in the General Settings Notebook gives you full control over more than
just these two colors.

The Window Groupbox

The Window groupbox is a set of radio buttons.  Each button corresponds to one
of the windows in Gibbon FTP.  To change the color of the Remote Directories
window, for example, select the Remote Directories radio button.

The Winow Area Groupbox

The Window Area groupbox is also a set of radio buttons.  Each button
corresponds to a particular area of the selected window; background, foreground
(or text) selected background, selected foreground, and borders.

Sample Text Area The Sampe Text area is below the Window Area groupbox.  It is
simply a text area with a border that allows you to see how the colors you
select will appear.

Color Bar

The Color Bar is on the far right side of the page.  It contains the 16 basic
system colors arrayed in two columns.  The two color squares at the bottom are
for user-defined colors.  To change the color of the selected color area,
simply click on the color you want.  If you click on one of the user-defined
colors squares at the bottom, spin buttons will appear that will allow you to
change the Red, Green and Blue component.

Spin Buttons

When the user-defined color is selected, the spin buttons for Red, Green, and
Blue appear at the bottom of the page.  These can be set to any value, allowing
you to set the color to any value desired.


ΓòÉΓòÉΓòÉ 8.5. Window Fonts ΓòÉΓòÉΓòÉ

There are two ways to change the fonts of various windows in Gibbon FTP. All
windows support the dropping of fonts from OS/2 system font palettes. In
addition, this page in the General Settings Notebook can be used to change the
fonts.

The Window Groupbox

The Window groupbox is a set of radio buttons.  Each button corresponds to one
of the windows in Gibbon FTP.  To change the font for the Remote Directories
window, for example, select the Remote Directories radio button.

Select Font Pushbutton

When the Select Font pushbutton is pressed, the standard system Font Dialog
will be displayed.  When a selection has been made, the the font for the sample
text below the pushbutton will be changed to provide a sample of how the font
will appear.

The currently selected font is displayed at the bottom of the page.


ΓòÉΓòÉΓòÉ 8.6. Window Other ΓòÉΓòÉΓòÉ

This page of the General Settings notebook is used to configure other
miscellaneous features.  At the current time, there are two options on this
page.

Button Bar

The Show button bar on session window checkbox is used to configure the display
of the button bar.  If this checkbox is checked, the button bar will be
displayed.  If it is not checked, the button bar will not be displayed.

Show Local

The Show the local files and directories checkbox is used to set the default
for the local file and directory windows.  This only effects the initial
visibility of the local file and directory windows. They can be toggled on and
off using the Display local directories menu item in the Windows menu, or the
corresponding button on the button bar.


ΓòÉΓòÉΓòÉ 8.7. Firewall ΓòÉΓòÉΓòÉ

The Firewall page in the General Settings notebook is used to configure access
through a firewall.  The controls on this page are:

 Enable Firewall     This checkbox is used to enable the firewall-specific
                     actions in Gibbon FTP.  If you are not behind a firewall,
                     this checkbox should not be checked.

 Use PASV mode       This is the first of two options for accessing FTP servers
                     through a firewall.  This is used if a firewall is
                     configured to allow outgoing connections, but not incoming
                     connections.

 Use Gateway proxy server This is the second of two options for accessing FTP
                     servers through a firewall.  This is used if there is an
                     FTP proxy or gateway on the firewall.

 Proxy requires login This checkbox is only enabled if the Use Gateway proxy
                     server radio button is selected.  This checkbox would be
                     checked of the gateway requires a user id or password
                     before allowing access.

 Proxy address       This entry field is only enabled if the Use Gateway proxy
                     server radio button is selected.  Enter the hostname or IP
                     address of the gateway server.

 Proxy port          This entry field is only enabled if the Use Gateway proxy
                     server radio button is selected.  Enter the port number of
                     the gateway server.

 Proxy user ID       This entry field is only enabled if the Proxy requires
                     login radio button is selected.  Enter your user ID for
                     the server.

 Proxy password      This entry field is only enabled if the Proxy requires
                     login radio button is selected.  Enter your password for
                     the server.

 See How do I use a firewall for more information about firewall setup.


ΓòÉΓòÉΓòÉ 9. Server Settings Notebook ΓòÉΓòÉΓòÉ

This notebook is used to configure individual servers.

The Server Settings notebook contains these pages:

 Connect        has the hostname or IP address of the server, a description, a
                checkbox for indicating if access is through a firewall,
                connection retries and two connections.

 Login          is used to set your user id and password.

 Files          sets the defaults for transfer mode, unique file names,
                timestamps, delete confirmations and directory cacheing.

 Paths          is used to set the starting local and remote directory.


ΓòÉΓòÉΓòÉ 9.1. Connect Notebook Page ΓòÉΓòÉΓòÉ

This page contains connection information for the server.  It has controls for
hostname, description, retries, firewall access, and two connections.

 Hostname and Description
 Connection Retries
 Access through firewall
 Attempt two Connections


ΓòÉΓòÉΓòÉ 9.1.1. Hostname and Description ΓòÉΓòÉΓòÉ

This section of the Connect page in the Server Settings notebook contains an
entry field for the hostname and a multi-line entry field for a description.

The Hostname or address field contains the hostname or IP address of the FTP
server.  If this field is empty, the server becomes a Generic server, similar
to the predefined ** Generic ** server, but has its own settings.

The Description and Comments multi-line entry field can be used to enter
comments about the server.


ΓòÉΓòÉΓòÉ 9.1.2. Connection Retries ΓòÉΓòÉΓòÉ

This groups of controls is used to set up connections retries. Retries are used
when a login fails because the server is not on-line, or there are too many
users logged in.

 Do not retry        This is the first radio button.  When selected, retries
                     will be disabled.

 Always retry        This is the second radio button.  When selected, a failed
                     login will always be retried.

 Prompt for retry    This is the third radion button.  When selected, if a
                     login fails, a message box will be displayed asking you if
                     you want to retry.  If you respond with Yes then retries
                     will be attempted.

 Retry every .. Seconds This is a spin button that is used to set the amount of
                     time to wait between retries.  It is recommended that this
                     be set no lower than 30 seconds.

 Stop after .. Tries This is a spin button that is used to set the maximum
                     number of times a login will be attempted before Gibbon
                     FTP gives up.


ΓòÉΓòÉΓòÉ 9.1.3. Access through firewall ΓòÉΓòÉΓòÉ

This checkbox is used to specify if this server should be accessed through the
firewall.  If firewall access is disabled in the General Settings notebook,
this checkbox will have no effect.  If firewall access is enabled in the
General settings notebook, this checkbox will determine if access to the server
will be direct or through the firewall.


ΓòÉΓòÉΓòÉ 9.1.4. Attempt two Connections ΓòÉΓòÉΓòÉ

This is a checkbox that is used to set the number of connections. If this is
checked, two connections will be attempted for the session.  The second
connection, if established, will be used to transfer files.  This keeps the
first connection free so you can continue to do other things while files are
being transferred.  You can, for example, change to other directories and look
for additional files to download.  Note that having only one connection will
not prevent you from looking at other directories and selecting files to
download if they are in the directory cache.

When two connections are requested, the status line at the bottom of the
session window will be split into two parts, one for each connection.

If you start transfering files before the second connection is established, the
second connection will take over and transfer any remaining files, so when the
transfer taking place on the first connection finishes, the first connection is
available for other tasks.


ΓòÉΓòÉΓòÉ 9.2. Login Notebook Page ΓòÉΓòÉΓòÉ

The Login notebook page is actually two pages in one.  There are two sets of
controls; one for anonymous logins, and one for non-anonymous logins.  Which
set is displayed depends on the Anonymous login checkbox.


ΓòÉΓòÉΓòÉ 9.2.1. Anonymous login checkbox ΓòÉΓòÉΓòÉ

If this box is checked, an anonymous login to the server will be performed, and
the other controls that appear on this page will be those related to anonymous
logins.  If this box is not checked, a normal login to the server will be
performed, and the other controls that appear on this page will be those
related to a normal login.


ΓòÉΓòÉΓòÉ 9.2.2. Anonymous Login ΓòÉΓòÉΓòÉ

This groups of controls is used to set up the defaults for anonymous logins.

 Use literal password This is the first radio button.  When selected, the
                     default anonymous password will be whatever is entered in
                     the Password entry field.

 Use Dialer email address This is the second radio button.  When selected, the
                     default anonymous password will be the email address
                     specified for the current Internet connection made using
                     the dialer.

 CLM User and hostname This is the third radio button.  When selected, the
                     default anonymous password will be constructed using the
                     current user id as retrieved from the Common Login Manager
                     (CLM) and the current hostname.  If you do not have CLM
                     running, this radio button will be disabled.

 CLM User and domain This is the fourth radio button.  When selected, the
                     default anonymous password will be constructed using the
                     current user id as retrieved from the Common Login Manager
                     (CLM) and the current domain name.  If you do not have CLM
                     running, this radio button will be disabled.

 Password            The contents of this entry field is used as the anonymous
                     password if the first radio button, Use literal password
                     is selected.

 The Common Login Manager (CLM) mentioned is a program included with some
 applications from Gibbon Computer Products, Inc.  If you don't have CLM or
 don't know what it is, just ignore these radio buttons.


ΓòÉΓòÉΓòÉ 9.2.3. Non-Anonymous logins ΓòÉΓòÉΓòÉ

This groups of controls is used to set up the defaults for non-anonymous
logins.

 User ID             This is your user ID on the remote system

 Password            This is your password on the remote system

 Account             This is your account on the remote system


ΓòÉΓòÉΓòÉ 9.3. Files Notebook Page ΓòÉΓòÉΓòÉ

This page is used to set the default transfer mode, caching, unique file names,
confirmations, and timestamps.  These settings are in four sections of the
page:

 Transfer mode
 Local Files
 Remote directory cache
 Remote Files


ΓòÉΓòÉΓòÉ 9.3.1. Transfer mode ΓòÉΓòÉΓòÉ

There are two radio buttons in this section of the Files setting page.  These
radio buttons are used to select either ASCII or Binary (Image) file transfers.
This is only the default, and it can be changed in the Session window.  Entries
in the File Types list in the General Settings notebook will override this
setting.


ΓòÉΓòÉΓòÉ 9.3.2. Local Files ΓòÉΓòÉΓòÉ

There are three checkboxes in this section of the Files setting page.

 Confirm local deletes If this is checked, a confirmation box will be displayed
                     before local files are deleted.

 Unique local names  When this is checked, if you download a file, and a file
                     with the same name already exists, a unique name will be
                     assigned.  For example, if you download a file named
                     README.NOW and there is already a file with that name on
                     your system, the new file will be called README.NO0.  Then
                     next time you download the file, it will be called
                     README.NO1. Confirm local overwrites item since these two
                     would conflict.

 Confirm local overwrites When this is checked, if you download a file, and a
                     file with the same name already exists, a confirmation
                     message will be displayed.  You can tell it to cancel the
                     transfer, overwrite the file, or restart the transfer. The
                     restart feature would be used if a previous transfer
                     stopped before it was finished.  This will allow you to
                     start the transfer where it left off.


ΓòÉΓòÉΓòÉ 9.3.3. Remote directory cache ΓòÉΓòÉΓòÉ

This section of the Files setting page contains two controls that are used to
set up directory caching:

 Cache remote directories This checkbox is used to enable or disable directory
                     caching.  If it is not checked, the remote directories
                     will not be cached.

 Directories to cache This spin button is used to specify how many directories
                     on the remote server are to be retained in the cache.

 The directory cache is maintained on a FIFO (First In First Out) basis. When
 the number of directories visited on the server exceeds the number of
 directories that are being cached, the directory least recently accessed  will
 be removed from the cache to make room for the new directory.

 Caching directories can use up a lot of memory, especially if the directories
 contain a lot of files.  It is probably not a good idea to cache a large
 number of directories.  On many systems, five should be plenty, and caching
 more than fifteen directories should almost never be necessary.


ΓòÉΓòÉΓòÉ 9.3.4. Remote Files ΓòÉΓòÉΓòÉ

There are three checkboxes in this section of the Files setting page.

 Confirm remote deletes If this is checked, a confirmation box will be
                     displayed before remote files are deleted.

 Unique remote names When this is checked, any files you upload to the remote
                     server will have a unique name, so it will not overwrite
                     any existing files.

 Set timestamp on GET When you download a file from a remote server, the file
                     normally ends up having the date and time the file was
                     downloaded.  When this is checked, the date and time on
                     the file will be changed to match the date and time on the
                     file as it was on the server.


ΓòÉΓòÉΓòÉ 9.4. Paths Notebook Page ΓòÉΓòÉΓòÉ

This page contains two entry fields that are used to set up initial paths on
the local and remote systems.

The Default Local Directory is the directory on your system that will be
current when you start the session.  If you enter anything in this field, you
should include the drive letter and the full path.  If you leave this field
blank, the default local directory that was set up in the General Settings
notebook will be used.  If that is also blank, the local directory will be set
to C:\

The Default Remote Directory is the directory in which you want to start on the
remote system.  If you leave this field blank, you will end up in the directory
the remote system has set up as the default.


ΓòÉΓòÉΓòÉ 10. Command Line Switches ΓòÉΓòÉΓòÉ

There are three command line switches available when starting Gibbon FTP.

 -d x      This is used to enable two debugging features.  x is a number that
           can have one of these values:

    1         Turn on the logging of directory listings received from the
              remote server in the Trace Log window.
    2         Write the contents of the Trace Log to a file.  The file name
              will be a series of numbers and have a file extension of .CTN.
              For example, it might be 67000001.CTN.
    3         Enable both of the above features.

 -q x      This is the Quite switch.  x is a number that can have one of these
           values:

    1         Turn off the confirmation box that appears when a session is
              closed and there are still files in the Transfer Queue.
    2         Turn off the confirmation box that appears when the Gibbon FTP
              application is closed and there are still one or more sessions
              still active.
    3         Turn off both of the above confirmations.

 -f        This switch would be used if you have a computer (such as a laptop)
           that is sometimes behind a firewall, and sometimes is not.  Instead
           of setting the Enable firewall checkbox in the General Settings
           notebook, you can leave it checked (firewall enabled).  When your
           computer is not behind a firewall, use the -f switch to disable the
           firewall features.


ΓòÉΓòÉΓòÉ 11. How Do I... ΓòÉΓòÉΓòÉ

This section contains tips and procedures.  It is organized like a question and
answer session.

The various subjects are organized into subjects to make it easier to find the
answers to your questions.  Within these subjects are the questions and
answers, sometimes grouped into topics.  For example, one of the subjects is
How Do I transfer files? that contains information about file transfer and one
of the topics is Canceling a file transfer

Subjects:

 How do I...
 ...work with Groups and Servers?
 ...start an FTP session?
 ...end an FTP session?
 ...transfer files?
 ...tell if I should use ASCII or Binary?
 ...view files?
 ...set up file types?
 ...use a firewall?
 ...show the help bubbles?
 ...change an alias or group name?
 ...change the font on the status line?


ΓòÉΓòÉΓòÉ 11.1. ...work with Groups and Servers? ΓòÉΓòÉΓòÉ

The Groups and Servers window is the first window that is displayed when you
start Gibbon FTP.  It has the server groups on the left, and the servers on the
right.

Each server is in one of the groups, and will only show up in the Servers
window when its group is active, except for the ** Generic ** server which is
in all groups.

Working with Groups and Servers covers alot of ground, so this subject is
broken up into these topics:

     Adding a new group
     Moving a group
     Deleting a group
     Adding a new server
     Moving a server
     Deleting a server
     Creating a generic server


ΓòÉΓòÉΓòÉ 11.1.1. Adding a new group ΓòÉΓòÉΓòÉ

There are several ways to create a new group.

Create Group menu item

The Create Group menu item will create a new root or first level group.  A
dialog box will appear where you can enter then name of the group.

Create Child Group

The Create Child Group menu item will create a group that is a child of the
current group.

Drag and Drop

You can use Ctrl+Drag (hold down the Ctrl key while dragging) to drag a group
folder, and drop it.  If you drop it on an empty area of the window, a root or
first level group will be created.  If you drop it on an existing group folder,
a child group will be created.


ΓòÉΓòÉΓòÉ 11.1.2. Moving a group ΓòÉΓòÉΓòÉ

Groups can be moved using Drag and Drop.  To move a child group to the root or
first level, you can drag the child group folder and drop it onto an empty area
of the window.  Any group can be made a child group of another group by
dragging the group folder and dropping it on the folder of the new parent
group.


ΓòÉΓòÉΓòÉ 11.1.3. Deleting a group ΓòÉΓòÉΓòÉ

You can delete a group by selecting the Delete Group menu item from that
group's pop-up menu.  There are two things to be aware of:

  1. You will only be allowed to delete a group if it doesn't have any child
     groups.  If it does, either delete the child groups first, or move the
     child groups.

  2. When you delete a group, all Servers in that group will be deleted also.


ΓòÉΓòÉΓòÉ 11.1.4. Adding a new server ΓòÉΓòÉΓòÉ

There are alot of ways to add a new Server.

Create Server menu item

Use the Create Server menu item.  This will create a new server in the current
group.  A dialog will appear where you can enter the Alias and Hostname for the
server.  The settings for the new server will be default settings, taken from
General Settings where possible.

Copy menuitem

The pop-up menu for servers includes a Copy menu item.  If you select this, a
dialog will appear where you can enter an Alias and Hostname. The Alias and
Hostname fields will be filled in with the Alias and Hostname of the server you
are copying.  The settings for the new server will be copied from the settings
of the server from which you are copying.

Drag and Drop Copy

You can drag an existing server and drop it on an empty area of the Servers
window.  This does a Server Copy as if you used the Copy menu item.

You can drag an existing server while holding the Ctrl key and drop it on a
Group folder.  This does a Server Copy as if you used the Copy menu item, but
puts the new server in the group on which it was dropped.

Drag and Drop from Session Window

There is a small Server icon in the title bar of the Session window.  You can
drag this icon, and drop it on an empty area of the Servers window, or on a
Group folder in the Groups window.  When you do this, the new server will be
created with the current directories set for both the Default Local Directory
and the Default Remote Directory.


ΓòÉΓòÉΓòÉ 11.1.5. Moving a server ΓòÉΓòÉΓòÉ

A server can be moved into a different group by using Drag and Drop.  Drag the
server and drop it onto a different Group folder.  The server will be moved to
the new group.


ΓòÉΓòÉΓòÉ 11.1.6. Deleting a server ΓòÉΓòÉΓòÉ

A server can be deleted by selecting the Delete menu item, or by deleting its
group.  When you delete a group, all servers that belong to that group are also
deleted.


ΓòÉΓòÉΓòÉ 11.1.7. Creating a generic server ΓòÉΓòÉΓòÉ

A Generic Server is a server that does not have a hostname or IP address.
Gibbon FTP has one predefined Generic server that shows up in every group. It
is called ** Generic ** and you can distiguish it from the others (assuming you
have the Server window set to show icons) because the icon is different.

The predefined Generic server uses the General Settings instead of Server
Settings for its defaults.  When you open a session using the Generic server,
you will be asked for a hostname or IP address.

You can create your own Generic servers also.  Create a new server using any of
the methods described in Adding a new server but leave the Hostname field
blank.  A blank Hostname tells Gibbon FTP that this is a Generic server.

When you open a session using your user-created Generic server, Gibbon FTP will
ask for a hostname or IP address just like it does with the predefined **
Generic ** server.  But instead of using General Settings, it will use the
settings that you set up for your user-created Generic server. You could, for
example, create a generic server that has the Access through firewall set, and
one that doesn't.  You could have one that is set up for no retries, and one
that is set up for retries.  You could set up several servers with different
Default Local Directories.  The possibilities are nearly endless.

Once you have some generic servers set up, you can use these almost like
templates.  Copy a generic server, give it an Alias and a Hostname, and the
rest of the settings will default from the generic server.


ΓòÉΓòÉΓòÉ 11.2. ...start an FTP session? ΓòÉΓòÉΓòÉ

There are three ways to start an FTP session:

  1. Use the Connect menu item from the server's pop-up menu.

  2. Double click the server

  3. Hilight the server and press the Enter or Return key

 If the server is the predefined ** Generic ** server, or a user-created
 generic server, a dialog will appear where you can enter the hostname.


ΓòÉΓòÉΓòÉ 11.3. ...end an FTP session? ΓòÉΓòÉΓòÉ

There are several ways to end an FTP session.

  1. Let the connection time out.  Not a recommended way to end a session, but
     the connection will close if the server times out.

  2. Select the Connect/Disconnect menu item on the Server menu.  This will
     close the connection, but will not close the Session window. Selecting the
     Connect/Disconnect menu item again will reconnect to the server.

  3. Use the  button on the button bar. This acts the same way as the
     Connect/Disconnect menu item.

  4. Double-click the system menu icon, select Close from the system menu, or
     press Alt+F4  These all do exactly the same thing. Both the connection and
     the Session window will be closed.  If there are any files in the Transfer
     Queue, you will get a confirmation box asking if you're sure.  You can
     disable this confirmation.  See Command Line Switches for how to do this.

  5. Use the  button on the button bar.  This acts the same way as using the
     system menu.

  6. On the Groups and Servers window, double-click the system menu icon,
     select Close from the system menu, or press Alt+F4. These all do exactly
     the same thing.  All connections and Session windows will be closed and
     Gibbon FTP will end.  If there are any Session windows open, you will get
     a confirmation box asking if you're sure.  You can disable this
     confirmation.  See Command Line Switches for how to do this.


ΓòÉΓòÉΓòÉ 11.4. ...transfer files? ΓòÉΓòÉΓòÉ

This subject is broken up into the following topics:

     Download files
     Upload files
     Canceling a file transfer


ΓòÉΓòÉΓòÉ 11.4.1. Download files ΓòÉΓòÉΓòÉ

There are several ways to start a download.

  1. Double-click on a file in the Remote Files window

  2. Select one or more files in the Remote Files window, bring up the pop-up
     menu using mouse button 2, and select the Download File, View File or
     Restart Download menu items.

  3. Select one or more files in the Remote Files window and click on the
     Download or  View buttons on the button bar.

  4. Select one or more files in the Remote Files window, then drag the
     selected files and drop them on the Local Files window, or one of the
     directories in the Local directories window.

  5. Select one or more files in the Remote Files window, then drag the
     selected files and drop them on the desktop, an OS/2 folder, or a drives
     object.  Note that if you use this method, the icon for the file will not
     necessarily end up where you dropped it.  Since the file is not
     transferred immediately, there is no way for the desktop, a folder, or the
     drives object to create the icon and set its location.

 Note:  All file transfers will go through the Transfer Queue.


ΓòÉΓòÉΓòÉ 11.4.2. Upload files ΓòÉΓòÉΓòÉ

There are several ways to start a download.

  1. Double-click on a file in the Local Files window

  2. Select one or more files in the Local Files window, bring up the pop-up
     menu using mouse button 2, and select the Upload File menu item.

  3. Select one or more files in the Local Files window and click on the
     Upload button on the button bar.

  4. Select one or more files in the Local Files window, then drag the selected
     files and drop them on the Remote Files window, or one of the directories
     in the Remote directories window.

  5. Select one or more files on the desktop, an OS/2 folder, or a drives
     object, then drag the selected files and drop them in the Remote Files
     window or one of the directories in the Remote Directories window.

 Note:  All file transfers will go through the Transfer Queue.


ΓòÉΓòÉΓòÉ 11.4.3. Canceling a file transfer ΓòÉΓòÉΓòÉ

If a file is currently being transferred, bring up the Transfer Status window
using the Transfer Status menu item on the Windows menu or the  button on the
button bar.  Then press the Cancel Transfer pushbutton.

If the file transfer has not yet started, bring up the Transfer Queue window
using the Transfer Queue menu item on the Windows or the  button on the button
bar.  Then find the file in the list, hilight it, and press the Delete Entry
pushbutton.


ΓòÉΓòÉΓòÉ 11.5. ...tell if I should use ASCII or Binary? ΓòÉΓòÉΓòÉ

There are several places in the program where you can set the transfer mode to
either ASCII or Binary.  You may be wondering what the difference is, and under
what circumstances each one should be used.

Some files can, or even should be modified when they are sent or received.  A
text file, such as a README file, or an email message, is made up of lines of
text that end with special characters.  On DOS and OS/2, these end-of-line
characters are a Carriage Return (or CR) and a Line Feed (or LF).  Other
operating systems, such as Unix and Macintosh, only have a LF at the end of the
line.  When you send a text file to a Unix system, the CR needs to be stripped
off, since the CR is not a valid line termination character.  When receiving a
file from a Unix system, it will only have a LF character at the end of the
line, so a CR character needs to be added.  When you transfer a file using
ASCII mode, this is exactly what happens.  When receiving a file, the FTP
server handles this translation. When sending a file Gibbon FTP does it.

Other files, such as programs, and ZIP files, are not made up of readable text.
These files should not be changed in any way.  If these kinds of files are
transferred using ASCII mode, CR/LF translation could occur, and that would
make the file unusable.  If it is a program, the program may not run at all, or
if it does, it would probably crash, or fail in some way.  These kinds of files
need to be transferred using Binary mode, also known as an Image transfer.  The
file is transferred as-is, with no translation.

There are also some computers that do not use the ASCII character set to
represent text.  For example, IBM mainframe computers running the MVS or CMS
operating systems use a charater set called EBCDIC (pronounced EB-see-dik). If
you trasfer a text file to or from a computer that uses the EBCDIC character
set, it must be transferred using ASCII mode.  The FTP server running on that
mainframe computer will see the request for an ASCII mode transfer, and it will
translate the file from EBCDIC to ASCII when it sends the file to you, or from
ASCII to EBCDIC when it receives the file from you.

In summary, text files should be transferred using ASCII transfer mode, and all
other files should be transferred using Binary transfer mode.


ΓòÉΓòÉΓòÉ 11.6. ...view files? ΓòÉΓòÉΓòÉ

Gibbon FTP can download and view files.  There is an internal file viewer that
can be used for text files.  For other types of files, you need to have another
program that Gibbon FTP will start.  For example, Gibbon FTP does not know how
to display Postscript files, so it would start a program (such as Ghostview)
that does know how to display Postscript.

You can use the File Types list to tell Gibbon FTP which files should always be
viewd, and what programs to use to view different types of files.  See How do I
set up file types? for an explanation of the File Types list.

To view a file with either the interal viewer or an external program:

 Use the View File menu item on the pop-up menu for the remote file or click on
 the  View button on the button bar.  If the file is not set up in the File
 Types list, a message box will be displayed asking you if you want to use the
 internal viewer.  Click on Yes to use the internal viewer.

 If the file you want to view is set up in the File Types list as a file that
 is always viewed, you don't have to specifically tell Gibbon FTP that you want
 to view the file.  It will automatically start the viewer when you download
 the file.

 Local files (those on your computer) normally cannot be viewed.  But it is
 possible in some circumstances.  Select one or more files in the Local Files
 window, then drag the selected files and drop them on a program object.  This
 method will only work for some programs.  WebExplorer/2 is one program that
 will work in this manner.


ΓòÉΓòÉΓòÉ 11.7. ...set up file types? ΓòÉΓòÉΓòÉ

The File Type list in the General Settings notebook is simply a list of files
with instructions on how Gibbon FTP should treat those files. There are about a
dozen file types that are predefined and added to the list the first time you
run Gibbon FTP.  You can look through this list to get an idea of how it works.

Each entry in the list has several pieces of information:

 File Type This is a drop-down list box that is used to select a file type.
           The File Type is simply a description, and contains entries like
           Postscript and JPeg Picture.

 file Mask This is the file mask that corresponds to the File Type.
           Meta-characters (wild cards) can be used.  An asterisk (*) is used
           to indicate any number of characters, and a question mark (?) is
           used to indicate any single character. These can be combined in a
           variety of ways, either simple or complex.  You could have a file
           mask of README.DOC that will only match the exact filename.  Or you
           could have a file mask of *READ*.??? that would match any file that
           has README anywhere in the name, and is followed by a period and
           three other characters.

 File viewer This is an entry field used to specify what program should be used
           to view a downloaded file.  If this field contains an asterisk (*)
           the internal viewer will be used.  If you want to specify an
           external program, enter the program name here.  If the program is
           noton the PATH, then you can enter the full path.  You can also
           enter any command line parameters that you normally use when
           starting the program.  The characters %s  should be included on the
           line.  When Gibbon FTP starts the program, it will include the
           filename of the downloaded file where you put the %s characters.

           For example, one of the predefined file types is JPEG Picture. The
           File viewer field contains: explore.exe -q file: ) telling it to
           shut down quietly (-q) and giving it the URL of the file (file:

 ASCII transfer Selecting this radio button indicates that this file type
           should always be transferred using ASCII transfer mode.

 Binary transfer Selecting this radio button indicates that this file type
           should always be transferred using Binary (or Image) transfer mode.

 Always use viewer If this checkbox is checked, the defined file viewer (either
           the internal viewer or an external program) will always be used.  If
           it is not checked, a viewer will be used to view the downloaded file
           only if you selected View File from the popup menu to transfer the
           file, or if you used the View button on the button bar.

 Keep file after viewing This checkbox is normally checked and disabled.  If
           you set up the file type to use the internal viewer (by putting an
           asterisk [*] in the File Viewer field) then this checkbox will be
           enabled.  If it is not  checked, the download will send the file to
           the internal viewer only and will not write the file to your disk.

 You can change any of the predefined file types, add new file types, and
 delete existing file types.


ΓòÉΓòÉΓòÉ 11.8. ...use a firewall? ΓòÉΓòÉΓòÉ

Gibbon FTP is able to function while behind most firewalls.  It does not
currently handle Socks firewalls, but should be usable through any other type
of firewall.  The setup for firewalls is done on the Firewall page of the
General Settings notebook.

One type of firewall allows outgoing connections to happen without
interference, but does not allow incoming connections.  This is a problem for
many applications, and FTP clients in particular.  When an FTP client requests
a directory listing or a file from a remote server, the usual procedure is for
the remote server to make the data connection.  The firewall will not allow
this to happen.  The way around this problem is to use what is known as PASV
(Passive) mode.  Using this, the FTP client asks the remote server to make a
connection available, then the client makes the connection. This way all
connections are outgoing and pass through the firewall.

Another type of firewall is even more restrictive in many ways, in that it
doesn't allow any incoming or outgoing connections.  This type of firewall uses
proxy servers.  The proxy server runs on the firewall and has access to both
the internal network and the Internet.  In this case, the FTP client connects
first to the proxy server (or FTP gateway).  The proxy server will usually make
sure the user is allowed access.  After verifying that the user is authorized,
the FTP client program then tells the proxy which server it wants to connect
to.  The proxy then makes the connection and relays commands, replies, and data
between the remote server and the client program. Gibbon FTP can work with both
of these types of firewalls.

Setting up PASV mode:

  1. Open the General Settings notebook and turn to the Firewall page.  Check
     the Enable Firewall checkbox.

  2. Select the Use PASV mode radio button.

  3. Close the General Settings notebook.

  4. Open the settings notebook for each server and check the Access through
     firewall checkbox on the first page.

 Setting up Proxy mode

  1. Open the General Settings notebook and turn to the Firewall page.  Check
     the Enable Firewall checkbox.

  2. Select the Use Gateway proxy server radio button.

  3. If your gatway requires you to log in, check the Proxy requires login
     checkbox.

  4. Enter the hostname or IP address of the gateway in the Proxy address entry
     field.

  5. Enter the port number to use in the Proxy port entry field. This is often
     port 21, and this field defaults to that port.  If you don't know which
     port to use, ask your security administrator.

  6. If your gatway requires you to log in, enter your user ID in the Proxy
     user ID entry field.

  7. If your gatway requires you to log in, enter your password in the Proxy
     password entry field.  If you want to be prompted for your password, you
     can leave this field blank.  Gibbon FTP will then ask you for your
     password each time.

  8. Close the General Settings notebook.

  9. Open the settings notebook for each server and check the Access through
     firewall checkbox on the first page.

 Notes about S/Key Challenges

 Some gateways require you to log in, but instead of using a static password,
 they use an S/Key challenge.  Gibbon FTP doesn't directly support S/Key and
 similar schemes, but it can be used in these circumstances.

 To set this up:

  1. Follow the procedure outlined above for setting up Proxy mode.  Enter your
     user ID, but leave the Proxy password field blank.

  2. When you connect to the gateway, Gibbon FTP will notice that you don't
     have the password entered, and will put up a dialog box so you can enter
     it. At this point, leave the password field blank, and click on the OK
     button.

  3. Gibbon FTP will send your user ID to the gateway.  When the gateway
     responds, Gibbon FTP will look for the word challenge in the response.  It
     is usually something like Skey Challenge: s/key 123 ab12345.

  4. The program will then prompt you for your password again, but it will
     display the S/Key challenge.  Calculate the correct response and enter it
     in the Password field.

  5. If the response does not include the word challenge you can still log in,
     but you will need to open either the Trace Log window or the Server
     Messages window in order to see the challenge.


ΓòÉΓòÉΓòÉ 11.9. ...show the help bubbles? ΓòÉΓòÉΓòÉ

Gibbon FTP has Help Bubbles attached to some of the controls. You can see these
by pressing mouse button 2 while the mouse pointer is over a control that has a
help bubble defined.  The buttons on the button bar each have a descriptive
help bubble defined, as does the status line at the bottom of the Session
window.  The help bubble will remain visible as long as mouse button 2 is
pressed.


ΓòÉΓòÉΓòÉ 11.10. ...change an alias or group name? ΓòÉΓòÉΓòÉ

At some point, you may decide to change a Server Alias or a Group name. You can
do it using direct edit.  Click on the Group or Server you want to change with
mouse button 1 (usually the left button) while holding down the ALT key.  The
text can now be change to whatever you want. When you're finished, click
anywhere else in the window.  The new Alias or Group name will be saved.


ΓòÉΓòÉΓòÉ 11.11. ...change the font on the status line? ΓòÉΓòÉΓòÉ

The font used for the status line at the bottom of the Session window can be
changed, but not by using the Fonts page in the General Settings notebook.  The
status line font can only be changed by dropping a font from a system font
palette.  Bring up the font palette (it's usually in the OS/2 System Setup
folder), select a font, then drag and drop it onto the status line.

When the font changes, the status line will not resize to match the height of
the font.  It will, however, be the correct height the next time you open a
session.  So if you want to change the status line font, that should probably
be one of the last things you do before closing the session.


ΓòÉΓòÉΓòÉ 12. What's Planned for version 1.1 ΓòÉΓòÉΓòÉ

Plans are already being made Gibbon FTP version 1.1.  There are some features
that need to be added.  There are also some things that need to be done, but I
didn't want to delay the release any longer.

 o This help file needs to be cleaned up a little, organized a little better,
   and index entries added.

 o Scripting will be added in version 1.1.  That will most likely be done using
   a REXX interface.

 o Verson 1.0 doesn't do proxy transfers or directory transfers.  These
   capabilities will be added in version 1.1.

 o Resolving directory links can sometimes take a long time (try going to
   ftp.cdrom.com and switch to the /pub directory for a good example.)  Version
   1.1 will change how directory links are handled.

 o Version 1.1 will allow viewing of local files.

 o If a session times out, version 1.0 clears the Remote Directories and Remote
   Files windows.  You have to manually reconnect if you want to continue
   browsing or transferring files.  Version 1.1 will leave the contents of the
   Remote Directories and Remote Files windows showing, and will automatically
   reconnect if needed.

 o Additional command-line paramters will be added, including the abilitity to
   run a script at startup, or to specify a server to connect to.  It will
   probably accept a URL style command-line argument such as: ftp: to
   ftp.gibbon.com, change to the /pub/gcp directory and download the file
   gcpftp11.zip.

 o Any reported bugs or strage behavior will be fixed.

 o Enhancement requests will be considered, and some or all will be added.

 In addition, the items on the following list possibly, maybe, might be done.

 o Ability to do Archie searches.

 o Socks server support

 o Other enhancements to firewall operation

 o Add a .COMMENT extended attribute to downloaded files with the date and time
   the download occured, and from where the file was downloaded.

 o Enhancements to the internal viewer.

 o Better segregation of parts of the program so a crash doesn't bring the
   entire program down.

 o Anything else I can think of.

 If there is anything you don't like about Gibbon FTP, or if you have any
 problems or requests, please let me know.


ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ

Copyright (c) 1983 Regents of the University of California.
All rights reserved.

Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions are met:

  1. Redistributions of source code must retain the above copyright notice,
     this list of conditions and the following disclaimer.
  2. Redistributions in binary form must reproduce the above copyright notice,
     this list of conditions and the following disclaimer in the documentation
     and/or other materials provided with the distribution.
  3. All advertising materials mentioning features or use of this software must
     display the following acknowledgement:

     This product includes software developed by the University of California,
     Berkeley and its contributors.


  4. Neither the name of the University nor the names of its contributors may
     be used to endorse or promote products derived from this software without
     specific prior written permission.

 THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND ANY
 EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
 WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
 DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE FOR ANY
 DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
 (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
 LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
 ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
 (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
 SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.


ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ

PGP is a trademark of Philip R.